CCCCCCCCCCCC
CCCCCCCCCCCC
CCCC
CCCC   ooooooo
CCCC   oo   oo  nnn                                    
CCCC   oo   oo  n n t r i b u t e d   Library  for the ChemStation
CCCC   oo   oo  n n
CCCC   ooooooo
CCCC
CCCCCCCCCCCC
CCCCCCCCCCCC

ChemStation A.05.0x and higher

Date: 15/01/01
Macro Contribution:  SUBBLANK.MAC #6

Revision History
----------------

  1. A.04.xx 01-Dec-96  initial version for A.03.0x and A.04.0x
  2. A.05.xx 16-May-97  adapted for A.05.0x
  3. A.08.xx 15-Jan-01  adapted for WPS



Contribution:  Example macro to allow subtraction of a designated blank
               data file from the current data file.

Contribution Structure
----------------------

The following macros are included in macro file SUBBLANK.MAC ...

 1. SUB_BLANK         - PostInteg HOOK macro to:
                         I.  Updated BLANK FILE if VIAL based selection
                         II. Subtracts BLANK from CURRENT DATA FILE
 2. BLANK_PREF        - PreSeq HOOK macro for entry of blank subtraction
                        preference.
 3. Install_SUBBLANK  - Creates/Updates USER.MAC to include
  		        loading of SUBBLANK.MAC during initialization of
			the Chemstation.

Prerequisites
-------------

       - Microsoft operating system as supported by
	 the revision of the ChemStation in use  
       - ChemStation A.05.xx or higher

Installation
------------


	* Copy files to the ChemStation's executable directory as follows:

                   SUBBLANK.MAC  -->  C:\Chem32\CORE\SUBBLANK.MAC 


Macro Loading (First Time Installation Only)
--------------------------------------------

	* Load the main macro, SUBBLANK.MAC, into the ChemStation via 
          the Command Line using:

		    MACRO SUBBLANK.MAC,GO

        * Close and re-initialize the Chemstation



The macro is checking which autosampler is installed. 

Blank Subtraction Preferences for NON WPS:
------------------------------------------

I.     Each time "Run Sequence" is selected from the "Method And Run Control"
       view "RunControl" menu, the following blank subtraction preferences are
       presented:

       A.  NONE
       --------

           This button disables blank file subtraction for this sequence run.


       B.  BY VIAL
       -----------

           This button enables blank file subtraction based upon a given vial
           number.  The following entry cases are possible.

           1.  -1 (No Vial Injection)

               The ChemStation allow execution of a NO VIAL injection in
               which the autosampler is not utilized and the run is immediately
               started.  This is accomplished by removing the vial number entry
               in the sequence line.  This selection allows the macro SUBBLANK
               to monitor the current run's vial number to preform the following
               procedures:

               a.  If NO VIAL injection, update the blank data file variable
                   with the current data file name
 
               b.  If VIAL injection, subtract the currently defined blank file
                   from the current data file.

           2.  Vial #

               This selection allows the macro SUBBLANK to monitor the current
               run's vial number to perform the following procedures:

               a.  If current run's vial number matches selected vial number, 
                   update the blank file variable with the current data file
                   name.

               b.  If current run's vial number does not match selected vial
                   number, subtract the currently defined blank file from the 
                   current data file.

 
        C.  BY FILE
        -----------

            This allows manual selection of a file for use as the blank file.
            Macro SUBBLANK automatically subtracts the selected file from
            every run in the sequence.


Blank Subtraction Preferences for WPS:
-------------------------------------


I.     Each time "Run Sequence" is selected from the "Method And Run Control"
       view "RunControl" menu, the following blank subtraction preferences are
       presented:

       A.  NONE
       --------

           This button disables blank file subtraction for this sequence run.


       B.  BY POSITION
       ---------------

           This button enables blank file subtraction based upon a given Well
           Plate Position.  Well Plate Blank Position Information entry is as 
           follows:

           1.  Plate Number

               The Plate Number allows selection of the Well Plate blank well

               Plate 1 = Well Plate 1
               Plate 2 = Well Plate 2
               No Inj  = No injection run (sequence table "location" is left
                         blank)

           2.  Blank Well Information

               The blank well information consists of choosing a row letter and
               a column number to designate the blank well position

               Row     = Letter depicting the row in the Well Plate
               Column  = Number depicting the column in the Well Plate

   
        C.  BY FILE
        -----------

            This allows manual selection of a data file for use as the blank file.
            The selected file is automatically subtracted from every run in the 
            sequence.


        D.  Save Subtracted Data (CHROMREG.WIN)
        ---------------------------------------

            Enabling this selection allows the subtracted raw data to be saved
            to a disk file (CHROMREG.WIN) inside the current data file directory
            using the Window Functions.  This subtracted raw data can then be
            retrieved using the View|Window Functions|Load Window menu choices.




System File Modification During Initial Macro Installation:
------------------------------------------------------------

I.	USER.MAC

	The following lines are appended to the end of file USER.MAC

        !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
        ! Section added for SUBBLANK.MAC AUTOLOAD                   !!
        !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
        Macro "SUBBLANK.MAC"
        SetHook "PreSeq","Blank_Pref"
        SetHook "PostInteg","Sub_Blank"
        Remove Install_SubBlank
        !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
**************************************************************************